home *** CD-ROM | disk | FTP | other *** search
/ Aminet 33 / Aminet 33 - October 1999.iso / Aminet / gfx / show / vmpeg.lha / vmpeg.readme < prev    next >
Encoding:
Text File  |  1999-07-06  |  3.4 KB  |  115 lines

  1. Short:    WarpOS port of MPEG2 video decoder
  2. Author:   frank@phoenix.owl.de (Frank Wille)
  3. Uploader: frank@phoenix.owl.de
  4. Version:  0.3
  5. Type:     gfx/show
  6. Requires: CSPPC or BPPC, WarpOS V4 (powerpc.library V15), AHI
  7.  
  8. vmpeg is another MPEG1/2 video player, based on the public source of
  9. the MPEG Software Simulation Group.
  10.  
  11. The last days I checked all MPEG players for the Amiga, but found no
  12. one which is able to play a standard 352x288 MPEG movie with sound
  13. in real time. This one does - at least with a 604e/233 and a fast
  14. graphics board (a 200 MHz 604e is already critical).
  15.  
  16.  
  17. FEATURES
  18.  
  19. - Cybergraphics/Picasso96 support (8-bit dithered or 15/16/32 bit
  20.   true color). Either by direct frame buffer access (-o4) or by using
  21.   Cybergraphics (-o5, very slow).
  22.  
  23. - Picasso96 PIP support (-o6).
  24.  
  25. - Automatic centering on graphics boards, in case the screen mode is
  26.   larger than the required display.
  27.  
  28. - Audio support via ahi.device unit 0.
  29.  
  30. - Tries to run at natural frame rate. When it's running too fast,
  31.   the player will wait after every frame, and when running too slow it
  32.   will start skipping B-frames. This should prevent interruptions of
  33.   audio output.
  34.  
  35. - Option -a prevents frame-skipping and plays all frames. Sound will
  36.   be disabled.
  37.  
  38. - User may define the fps-rate, used for replay (-d). Sound will be
  39.   disabled.
  40.  
  41. - Fps counter display.
  42.  
  43. - Time code display.
  44.  
  45. - Backward/Forward seek function. You can scan through the whole
  46.   movie by using the mouse.
  47.  
  48. - Several work-arounds to be compatible with all movies I have seen.
  49.  
  50. - Compiled by latest vbcc in highest optimization mode.
  51.  
  52. - Some PPC Assembler optimizations.
  53.  
  54.  
  55. USAGE
  56.  
  57. To view a movie with sound enabled just type
  58.  
  59.   vmpeg -o4 -s -b cd0:movie.mpg
  60.  
  61. A screen mode requester will open where you can select your prefered
  62. resolution. 8 bit screens automatically force dithering mode. You should
  63. define a screen mode with a resolution of 352x288 pixels. vmpeg runs
  64. best at 15/16 bits, which is even faster than 8 bit.
  65.  
  66. Pressing the right mouse button will display the current time code.
  67. When moving the mouse right or left, while holding the right button,
  68. you can seek for/backwards in the MPEG stream. Move the mouse very
  69. slowly! The stream is seeked in multiples of 1 MB. By looking at the
  70. time code you should easily find the position where you last stopped
  71. watching the movie.
  72.  
  73. Backwards seeking is nearly unusable with FastFileSystem in large
  74. files, but works very well with others, like a CD-FileSystem or PFS/SFS.
  75.  
  76. To quit, press the left mouse button or the ESC key.
  77.  
  78. For more options, you may start vmpeg without arguments to get a
  79. complete list.
  80.  
  81.  
  82. FIXED BUGS SINCE 0.1
  83.  
  84. - -m option to select screen mode id didn't work
  85.  
  86. - All screen modes only worked for some graphics boards (e.g. CV64
  87.   and PicaossIV). On other boards, only a few modes worked (e.g.
  88.   on CVPPC and BVPPC).
  89.  
  90.  
  91. BUGS
  92.  
  93. - Slow down of fast movies could work better, when having sound enabled.
  94.  
  95. - True color display modes doesn't support other chroma formats
  96.   or interlaced movies. Haven't seen those, though.
  97.  
  98. - Fps counter seems to be wrong in fast movies (?).
  99.  
  100.  
  101. SOURCE
  102.  
  103. Full source code is included. To recompile, you need the latest vbcc
  104. compiler and a make-program (the makefile is very simple, so that
  105. most 'makes' should work). If you have problems, try a lower optimization
  106. mode, or write me to get a compiler update.
  107.  
  108.  
  109. LEGAL
  110.  
  111. vmpeg is freeware, of course.
  112.  
  113.  
  114. Frank Wille                  27-Jun-1999                frank@phoenix.owl.de
  115.